package com.apigen.platform.service;

import com.apigen.platform.dto.CaptchaResponse;

/**
 * 验证码服务接口
 *
 * @author API Generator Platform
 * @since 2025-09-24
 */
public interface ICaptchaService {

    /**
     * 生成验证码
     * 
     * @return 验证码响应信息
     */
    CaptchaResponse generateCaptcha();

    /**
     * 验证验证码
     * 
     * @param captchaId 验证码ID
     * @param captchaCode 用户输入的验证码
     * @return 验证是否成功
     */
    boolean validateCaptcha(String captchaId, String captchaCode);

    /**
     * 刷新验证码
     * 
     * @param captchaId 旧的验证码ID
     * @return 新的验证码响应信息
     */
    CaptchaResponse refreshCaptcha(String captchaId);

    /**
     * 清理过期验证码
     */
    void cleanExpiredCaptcha();
}
